home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / MorphOS / vbcc / vbcc_MorphOS.readme
Text File  |  2002-10-27  |  5KB  |  165 lines
  1. Short:    optimizing ISO C compiler (MorphOS-native binaries)
  2. Uploader: frank@phoenix.owl.de (Frank Wille)
  3. Author:   vb@compilers.de (Volker Barthelmann), frank@phoenix.owl.de (Frank Wille)
  4. Type:     dev/c
  5. Version:  0.8
  6. Requires: dev/c/vbcc.lha
  7.  
  8.  
  9. vbcc - portable ISO/ANSI C compiler (c) in 1995-2001 by Volker Barthelmann
  10.  
  11.  
  12. INTRODUCTION
  13.  
  14.     vbcc is a portable and retargetable ISO/ANSI C compiler.
  15.  
  16.     This archive contains the MorphOS-native versions of the compiler,
  17.     preprocessor, assembler, linker and frontend, as well as a new set
  18.     of config files for MorphOS-native use.
  19.  
  20.     Note that you will need the main archive from dev/c/vbcc.lha, which
  21.     includes all the libraries and header files, to get a running system.
  22.     Just unpack this archive over the main archive to get a MorphOS-native
  23.     compiler system.
  24.  
  25.     Most tools in this distribution (except PhxAss) are provided as
  26.     binaries running natively under MorphOS.
  27.  
  28.     All major parts of this distribution (including compiler,
  29.     preprocessor, libraries etc.) have been built using this system.
  30.  
  31.  
  32. FEATURES
  33.  
  34.     vbcc..
  35.  
  36.     - is portable and retargetable
  37.  
  38.     - comes with a global optimizer that can e.g. do common subexpression
  39.       elimination, constant propagation, function inlining and several
  40.       other optimizations across functions and modules (depending on
  41.       optimization level)
  42.  
  43.     - should be compliant to ANSI/ISO89 and partially ISO99
  44.  
  45.     - can generate code that runs on a plain 68000 CPU
  46.  
  47.     - can generate code optimized for 020/030, 040 or 060
  48.  
  49.     - can generate code that uses the 68881/2, 68040/060 FPUs directly
  50.       and comes with appropriate math-libraries
  51.  
  52.     - can generate code that runs on PowerUp-boards or MorphOS systems
  53.  
  54.     - generates standard Amiga-68k-objects, PPC-ELF-objects or
  55.       WarpOS-EHF-objects
  56.  
  57.     - offers a lot of useful extensions like variable-attributes
  58.       and #pragmas
  59.  
  60.     - comes with a message browser
  61.  
  62.     - comes with a config program
  63.  
  64.     - offers a lot of error/warning messages that can be turned on/off
  65.       separately
  66.  
  67.  
  68. WHAT'S NEW
  69.  
  70.     Some changes since the last Amiga release:
  71.  
  72.     - bug fixes in the compiler, optimizer, tools and libraries
  73.  
  74.     - improved code-generation
  75.  
  76.     - improved optimizations, including inter-procedural,
  77.       cross-module optimizations and alias-analysis
  78.  
  79.     - support for some c99 features, including
  80.       - long long
  81.       - flexible array members as last element of a struct
  82.       - mixed statements and declarations
  83.       - declarations within for-loops
  84.       - inline function-specifier
  85.       - restrict-qualifier
  86.       - vararg-macros
  87.       - _Pragma
  88.       - increased translation-limits
  89.       - stdint.h
  90.  
  91.     - stack-checking and measurement of stack-usage
  92.  
  93.     - documentation as pdf and html documents
  94.  
  95.     - new attributes (e.g. __amigainterrupt, __section)
  96.  
  97.     - new #pragmas for PPC (amiga-align etc.)
  98.  
  99.     - inline-headers for WarpOS PPC-native libraries
  100.  
  101.     - (backend-specific) predefined macros
  102.  
  103.     - improved libaries and headers
  104.  
  105.     - new versions of Frank Wille's assemblers and linkers
  106.  
  107.     - use of a builtin preprocessor
  108.  
  109.     - support for MorphOS
  110.  
  111.  
  112.  
  113. REQUIREMENTS
  114.  
  115.     To use vbcc/MorphOS you need:
  116.  
  117.     - a system running MorphOS V.. or higher
  118.  
  119.     - enough RAM (it is possible to translate small programs with 1MB, but
  120.       for larger programs much more will be needed)
  121.  
  122.     Stuff that is not needed, but may be very useful:
  123.  
  124.     - harddisk
  125.  
  126.     - editor
  127.  
  128.     - make, touch etc.
  129.  
  130.     - the Amiga OS-includes (they can be found on certain CDs)
  131.  
  132.     - pipe-command (to use the message browser)
  133.  
  134.     Also you should know how to use the shell and you should know ANSI C
  135.     (if you need a book I recommend (like everyone) "The C Programming
  136.     Language, Second Edition, ANSI C" by Kernighan and Ritchie).
  137.  
  138.  
  139. DOCUMENTATION
  140.  
  141.     Look for documentation in the doc-subdirectory of the vbcc.lha
  142.     main archive.
  143.  
  144.  
  145. BUGREPORTS/COMMENTS
  146.  
  147.     If you think vbcc generates bad code, throws enforcer hits, crashes,
  148.     seems to be not ISO-compliant etc. and the problem is not mentioned
  149.     anywhere in the docs as known problem, please send a mail with your
  150.     system configuration, the vbcc version, the command line you used, the
  151.     source that caused the problem and a brief description of the problem
  152.     to
  153.  
  154.         vb@compilers.de           and/or
  155.         frank@phoenix.owl.de
  156.  
  157.     Also if you find problems with the includes, the libraries or you have
  158.     suggestions, dislikes etc. send us a mail.
  159.     Corrections, improvements etc. of the manuals are appreciated, too.
  160.  
  161.  
  162.  
  163. Volker Barthelmann                                   vb@compilers.de
  164. Frank Wille                                          frank@phoenix.owl.de
  165.